import request from "@/utils/request";

const USERSTUDYWORDHISTORY_BASE_URL = "/api/v1/user-study-word-history";

const UserStudyWordHistoryAPI = {
    /** 获取历史单词学习记录分页数据 */
    getPage(queryParams?: UserStudyWordHistoryPageQuery) {
        return request<any, PageResult<UserStudyWordHistoryPageVO[]>>({
            url: `${USERSTUDYWORDHISTORY_BASE_URL}/page`,
            method: "get",
            params: queryParams,
        });
    },
    /**
     * 获取历史单词学习记录表单数据
     *
     * @param id 历史单词学习记录ID
     * @returns 历史单词学习记录表单数据
     */
    getFormData(id: number) {
        return request<any, UserStudyWordHistoryForm>({
            url: `${USERSTUDYWORDHISTORY_BASE_URL}/${id}/form`,
            method: "get",
        });
    },

    /**
     *  添加历史单词学习记录
     *
     *  @param data 历史单词学习记录表单数据
     */
    add(data: UserStudyWordHistoryForm) {
        return request({
            url: `${USERSTUDYWORDHISTORY_BASE_URL}`,
            method: "post",
            data: data,
        });
    },

    /**
     * 更新历史单词学习记录
     *
     * @param id 历史单词学习记录ID
     * @param data 历史单词学习记录表单数据
     */
     update(id: number, data: UserStudyWordHistoryForm) {
        return request({
            url: `${USERSTUDYWORDHISTORY_BASE_URL}/${id}`,
            method: "put",
            data: data,
        });
    },

    /**
     * 批量删除历史单词学习记录，多个以英文逗号(,)分割
     *
     * @param ids 历史单词学习记录ID字符串，多个以英文逗号(,)分割
     */
     deleteByIds(ids: string) {
        return request({
            url: `${USERSTUDYWORDHISTORY_BASE_URL}/${ids}`,
            method: "delete",
        });
    }
}

export default UserStudyWordHistoryAPI;

/** 历史单词学习记录分页查询参数 */
export interface UserStudyWordHistoryPageQuery extends PageQuery {
    /** 学生ID */
    userId?: number;
    /** 单词ID */
    wordId?: number;
    /** 学习进度百分比 */
    studyPercent?: number;
    /** 学习次数 */
    studyTimes?: number;
    /** 错误次数 */
    studyWrongTimes?: number;
    /** 是否学习过 */
    isStudy?: number;
    /** 下次学习时间 */
    nextTime?: [string, string];
}

/** 历史单词学习记录表单对象 */
export interface UserStudyWordHistoryForm {
    /** 历史学习ID */
    id?:  number;
    /** 学生ID */
    userId?:  number;
    /** 系列ID */
    seriesId?:  number;
    /** 教材ID */
    programId?:  number;
    /** 单词ID */
    wordId?:  number;
    /** 所属单元ID */
    unitId?:  number;
    /** 单元名 */
    unitName?:  string;
    /** 学习ID */
    studyId?:  number;
    /** 来源 */
    source?:  string;
    /** 拼写 */
    spelling?:  string;
    /** 音节 */
    syllable?:  string;
    /** 中文释义 */
    meaningZhCn?:  string;
    /** 学习进度百分比 */
    studyPercent?:  number;
    /** 词汇等级 */
    wclass?:  string;
    /** 学习次数 */
    studyTimes?:  number;
    /** 错误次数 */
    studyWrongTimes?:  number;
    /** 是否学习过 */
    isStudy?:  number;
    /** 下次学习时间 */
    nextTime?:  Date;
}

/** 历史单词学习记录分页对象 */
export interface UserStudyWordHistoryPageVO {
    /** 历史学习ID */
    id?: number;
    /** 学生ID */
    userId?: number;
    /** 系列ID */
    seriesId?: number;
    /** 教材ID */
    programId?: number;
    /** 单词ID */
    wordId?: number;
    /** 所属单元ID */
    unitId?: number;
    /** 单元名 */
    unitName?: string;
    /** 学习ID */
    studyId?: number;
    /** 来源 */
    source?: string;
    /** 拼写 */
    spelling?: string;
    /** 音节 */
    syllable?: string;
    /** 中文释义 */
    meaningZhCn?: string;
    /** 学习进度百分比 */
    studyPercent?: number;
    /** 词汇等级 */
    wclass?: string;
    /** 学习次数 */
    studyTimes?: number;
    /** 错误次数 */
    studyWrongTimes?: number;
    /** 是否学习过 */
    isStudy?: number;
    /** 下次学习时间 */
    nextTime?: Date;
}
